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INTRODUCTION 


This  volume  contains  five  ROSCOE  sample  cases,  two  environment 
runs  (low-  and  high-altitude),  and  three  system  problems  (radar,  com¬ 
munication,  and  optics).  For  each  example  the  inputs  required  to  run 
the  problem  are  described.  These  are  followed  by  a  small  sample  of  the 
output  tables  and  plots  that  the  code  produces. 

The  sample  cases  were  generated  using  the  sample  data  deck  shown 
in  Volume  1-1  with  a  few  minor  changes  in  each  case.  The  structure  of 
this  input  deck  is  briefly  described  in  Section  2.  Section  3  follows 
with  a  description  of  specific  inputs  and  the  resulting  outputs  for 
each  sample  problem. 

Job  control  streams  using  the  sample  data  deck  are  provided  in 
Appendix  A,  and  brief  descriptions  of  permanent  files  used  during  ROSCOE 
execution  are  presented  in  Appendix  B.  Finally,  a  listing  of  the  sample 
data  deck  is  taken  from  Volume  1-1  and  repeated  in  Appendix  C  for  easy 
reference . 
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DATA  DECK  STRUCTURE 


The  sample  data  deck  is  scored  as  a  permanent  file  (file  name 
ROSCOEDATA)  in  UPDATE'*'  library  form  (deck  name  DATA),  and  contains  a 
sample  setup  for  almost  any  type  of  ROSCOE  problem  the  user  wishes  to 
run.  To  execute  a  particular  problem,  the  user  simply  changes  a  few 
of  the  stored  input  variables  via  an  UPDATE  command  (examples  are  shown 
below) .  A  working  knowledge  of  FLEXRED  and  DSA  (described  in  Volume 
1-1)  is  assumed. 

The  data  deck,  as  currently  structured,  allows  the  user  to  run 
environment,  radar  surveillance  and  tracking,  satellite  communication, 
and  optical  surveillance  and  tracking  problems.  The  input  variables 
in  the  sample  data  deck  are  grouped  as  follows: 

•  General  Inputs.  Include  event  list,  option  flags,  refer¬ 
ence  locations,  output  formats,  etc. 

•  Radar  Inputs.  Variables  required  to  simulate  radar  sur¬ 
veillance  or  tracking  performance. 

•  Sat-Com  Inputs.  Variables  required  to  simulate  a  satel¬ 
lite  communication  problem. 

•  Optics  Inputs.  Variables  required  to  simulate  optical 
sensor  surveillance  or  tracking  performance. 

•  Phenomenology  Inputs.  Variables  required  to  simulate  a 
burst  and  print  environment  outputs. 

To  run  a  specific  problem,  the  user  creates  a  set  of  changes  to  the 
data  deck.  The  change  package  starts  with  a  card  to  identify  the  deck  to 
be  charged  (in  this  case  DATA).  The  card  should  read  *COMPILE  DATA, 
starting  in  column  1.  This  card  is  followed  by  the  change  cards  themselves. 

^UPDATE  is  a  Control  Data  Corporation  program  which  provides  a  means  for 
editing  text  files. 


For  each  change,  the  user  must  prepare  an  UPDATE  edit  card  (e.g., 

*D  DATA. XXX  deletes  card  number  XXX  from  the  deck)  and  the  card(s) 
replacing  the  deleted  statement  (inserts  can  also  be  made).  The 
replacement  cards  must  conform  to  the  FLEXRED  format  described  in 
Volume  1-1. 

The  event  list  contained  in  the  general  input  section  is  the 
single  most  important  set  of  input  data.  This  list  drives  the  simu¬ 
lation.  In  the  sample  deck,  eleven  events  have  been  inserted  in  the 
event  list.  Two  of  the  events  (the  attack  generation  event  which  per 
forms  initialization  functions,  and  the  stop  event  which  terminates 
program  execution)  are  mandatory,  while  the  other  nine  are  optional. 
The  optional  events  (radar,  communications,  optics,  and  burst  events) 
have  been  given  very  large  event  times  so  that  the  program  (which  pro 
cesses  events  in  time  order)  will  hit  the  stop  event  before  executing 
them.  To  turn  on  any  one  of  these  events,  the  user  should  change  the 
event  time  relative  to  the  stop  event  time.  The  user  can  also  add 
additional  events  as  described  in  Volume  1-1. 
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3  SAMPLE  PROBLEMS 

This  section  describes  sample  problems  which  illustrate  some  of 
the  available  ROSCOE  input  and  output  options.  As  mentioned  earlier, 
two  environment  problems  (low-  and  high-altitude)  and  three  system 
problems  (radar  surveillance,  satellite  communication,  and  optical 
surveillance)  are  presented. 

3.1  LOW-ALTITUDE  ENVIRONMENT  PROBLEM 

To  run  a  simple  low-altitude  burst  problem,  consisting  of  a 
single  burst  and  with  the  following  assumptions: 


• 

Burst  time 

=  94.76 

seconds 

• 

Altitude  = 

8.8  kilometers 

• 

Yield  =  5 

kilotons 

• 

Output  every 

1  to  96 

seconds 

The  user  would  input  the  following  change  deck: 


[Cards  read  from  bottom  to  top] 


[STOP  TIME  ]  1 

'97.  0 

'SEC 

I 

1 

DATA.  1 1)94 

1 

! 

| 

1 

GRID  OUTFIT  DATASET  | 

1.0 

1 

[2EPDS 

f»D  DATA.  11S5 

t 

i 

I 

1 

[DELTA  PPItfT  TIME 

'1.0 

[SEC 

I 

1 

j»B  DATA.  1 161 

\ 

! 

1 

1 

(ENVIRONMENT  OUTPUT  T]IME 

'95.  0 

jSEL 

1 

f»B  DATA.UT3  1 

1 

1 

KT 

! 

1 

I  Y1IDJJ 

■D  DATA.  10(74  | 

5. 

| 

i 

i 

! 

1 

i 

BURST  POSITION  ! 

■D  DATA.  1005 

0. 

0. 

1 

'8.8 

1 

ILOCXYZ 

1 

[BURST  TIME  i 

94.76 

[SEC 

! 

! 

f»D  DATA.  1004 

1 

1 

1 

| 

(•COMPILE  Data  |  t 

1 

I 

i 

1 

1  '  >  •  -  '  '*  '  ‘1  *  '0 1' 

1  IIIM  (' 

«*  Vi  V 

C  •  M 

..  .  - 

•  *  «  '*  t  '» .1* .  L-alVH  .  i  •  «  i  «i, 
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In  this  example  the  Burst  Event  Dataset-1  and  Environment  Output 
Event  times  have  been  changed  relative  to  the  Stop  Event  time  so  that 
they  will  be  process  d.  The  grid  output  dataset  is  "zeroed,"  since  it 
is  only  appropriate  for  high-altitude  bursts  ( > 90  km). 

The  output  for  this  example  is  shown  in  Table  3.1.  There  are  six 
tabular  output  lists  provided,  including  burst  parameters;  three  sets  of 
fireball  parameters;  a  set  of  debris  parameters;  and  a  set  which  shows 
some  point  properties  (electron  density,  reflection  coefficient)  within 
or  near  the  fireball.  For  the  burst  parameters,  a  single  line  of  output 
is  provided  for  each  burst.  For  the  other  outputs,  separate  lines  of 
output  are  printed  at  the  calculation  times  requested  in  the  environment 
output  event. 

The  Burst  Parameter  headings  are  self-explanatory,  with  the  excep¬ 
tion  of  the  last  two  variables.  These  are  used  in  the  chemistry  routine 
to  flag  the  approximate  time  after  burst  when  the  fireball  temperature 
drops  to  3000°K  and  2000°K,  respectively. 

Fireball  Set-1  provides  the  fireball  radii,1  altitude,  rise  rate, 
expansion  rate,  density,  temperature,  and  time  since  burst  (or  time  since 
merge  for  merged  bursts)  at  a  series  of  calculation  times. 

Fireball  Set-2  gives  minimum  and  maximum  altitudes  at  which  the 

ellipsoidal  fireball  region  is  truncated,  the  orientation  of  the  fireball 

axis  in  terms  of  the  tilt  from  vertical  and  rotation  CCW  from  east,  the 
2 

vortex  radii,  the  vortex  volume,  and  a  characteristic  time  to  describe 
when  merges  have  occurred. 


^The  fireball  radial  dimensions  are  defined  in  Fig.  2.8  of  Volume  1. 
2 

The  vortex  radial  dimensions  are  defigned  in  Fig.  2.8  of  Volume  1. 


EXAMPLE  OUTPUT:  LOW-ALTITUDE  ENVIRONMENT  PROBLEM 


95,000  1  8.8?*  0.000  F!w£t>AU.  3.9*69EMS  7015.75?  73?I.3S?  l.01»8-?38 

98.0CO  »  8 .8*0  0.003  flW£ftl.LL  T.17*7£.l*  5303.715  1743.788  8.7311t-7» 


Fireball  Set-3  shows  the  fireball's  earth-centered  Cartesian 
coordinates,  a  shape  parameter  (oval  of  Cassini  parameter)  which  des¬ 
cribes  the  transition  of  the  fireball  from  ellipsoid  to  a  torus, ^  the 
2 

oval  arm  radius,  the  vortex  boundary  temperature,  and  two  indices  to 
provide  merging  information.  The  first  index,  "fireball  kind,"  can 
have  the  following  values: 

Definition 

Fireball  prior  to  torus  formation  (above 
100  km:  1  =  spheroid,  2  =  skewed  spheroid) 

Fireball  after  torus  formation 

Fireball  has  radiation-merged  with  new  one 

Fireball  has  hydromerged  with  another  one 

The  second  parameter,  "merge  ID  index,"  describes  where  a  merged  fire¬ 
ball  region  has  gone.  For  example,  for  radiation-merged  fireballs 
(fireball  kind  =  4),  the  index  number  of  the  new  merged  fireball  is 
given;  for  hydromerged  fireballs  (fireball  kind  *  5),  two  numbers  are 
given  (written  consecutively  to  form  the  index) ,  the  first  giving  the 
index  of  the  other  fireball  involved  in  the  merge,  and  the  second  the 
new  fireball  index. 

The  table  of  Debris  Parameters  provides  physical  data  for  the 
debris  region,  including:  total  energy,  altitude,  radius,  volume,  and 
a  "debris  distribution  parameter,"  which  describes  the  distribution  of 
fission  debris  as  a  function  of  the  horizontal  distance  from  the  field 
line  passing  through  the  center  of  the  region  (see  RANC  IV). 

^When  the  Oval  of  Cassini  parameter  is  1.0,  the  fireball  begins  to  look 
like  a  torus  (a  hole  forms).  The  larger  the  parameter,  the  more  toroidal 
the  shape. 

2 

See  Fig.  2.8  of  Volume  1. 


Fireball  Kind 
1-2 

3 

4 

5 
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Finally,  at  the  bottom  of  the  table  the  Detailed  Point  Data  are 
shown.  Electron  density,  temperature,  the  width  of  the  steep  temperature 
gradient  region  just  outside  the  fireball,  and  the  reflection  coefficient 
with  and  without  absorption  are  printed  as  a  function  of  time.  In  this 
example,  properties  for  only  one  point  at  the  fireball  center  are  com¬ 
puted  at  each  time.  The  user  can  increase  the  number  of  points  calculated 
inside  and  outside  the  fireball  region  by  changing  the  appropriate  para¬ 
meters  in  the  environment  output  event  dataset  (see  Volume  1-1). 

3.2  HIGH- ALTITUDE  ENVIRONMENT  PROBLEM 

To  run  a  high-altitude  environment  problem  assuming  the  following, 

•  Burst  time  =  0 

•  Burst  altitude  *  200  kilometers  (default) 

•  Yield  =  1  megaton  (default) 

•  Output  every  30  seconds  (default)  from  0  to  180 
the  user  would  input: 


[Cards  read  from  bottom  to  top] 


(STOP  TIME  1 
j*B  DATA.  11*54 
|END  PRINT  jTIME  | 

j»D  BATA.  1  l(8c 
piVIRDNMEtfT  OUTPUT  TIME 
BATA.  11178 

•BURST  TINE]  ] 

**H  DATA.  1 004  | 

^COMPILE  DATA 


When  a  high-altitude  (>90  km)  burst  is  simulated,  the  code  produces 
a  series  of  printer  plots,  as  well  as  tabular  outputs  at  items  specified 
by  the  Environment  Output  Event  input  variables  (DATA. 1177  through 
DATA. 1184).  The  Grid  Output  Dataset  sets  up  these  plots.  The  variable 
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"type"  defines  the  location  where  the  grid  cut  is  made:  type  FIREBALL 
indicates  that  a  cut  through  the  center  of  the  fireball  will  be  made; 
otherwise,  the  second  variable  "index"  is  used  to  define  the  index  of 
the  cell  in  the  X-  or  Y-  or  Z-direction  to  be  used.  the  "kind  of  input 
desired"  can  be  RHO  for  mass  density  plots,  NE  for  electron  density 
plots,  STRI  for  striation  fraction  plots,  TE  for  electron  temperature 
plots,  ALL  for  all  of  the  above  (default),  or  NONE  for  none  of  them. 

In  this  example,  the  default  values  are  used  for  the  grid  output, 
so  printer  plots  for  all  the  quantities  mentioned  are  produced  by  taking 
a  cut  through  the  grid  parallel  to  the  Y-axis  (normal  to  the  field), 
through  the  fireball  center.  The  grid  size  is  defined  in  the  Heave 
Coordinate  Dataset  (DATA. 522  -  DATA. 540).  The  dataset  values  specify 

a  6x6  grid  (36  columns)  with  each  cell  0.02  radians  on  a  side,  and  17 

vertical  cells. 

A  sample  of  the  grid  output  at  90.  s  after  burst  is  shown  in  Figs. 
3.1  through  3.9.  The  plots  include  a  picture  of  the  fireball  and  beta 
tube  region,  followed  by  tabular  and  graphic  representations  of  mass 
density,  electron  density,  electron  temperature,  and  striation  fraction. 

The  fireball  plots  are  made  in  a  plane  aligned  with  the  magnetic 
field  to  show  the  field  line  convergence  and  dip.  The  burst  point  is 
denoted  by  the  symbol  "+BP,"  the  fireball  region  is  denoted  by  the 

asterisks,  and  the  beta  tube  by  the  dotted  lines  which  emanate  from  the 

contained  debris.  The  dashed  lines  in  the  figure  represent  altitudes  of 
60  and  85  km. 

The  next  figure  (Fig.  3.2)  shows  mass  densities  as  a  function  of 
altitude  and  cell  numbers  within  the  grid.  The  mass  densities  in  equal 
altitude  increments  are  derived  by  interpolating  the  stored  grid  data. 
These  data  are  then  interpolated  further  to  produce  the  contour  plot 
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FIREBALL  at  7*  90,00000  Src 


Figure  3.1.  Fireball  Shape  at  90  seconds  for  Sample  Environment  Problem 


Figure  3.2.  Mass  Densities  at  90  seconds  for  Sample  Environment  Problem 


Figure  3.3.  Mass  Density  Contours  at  90  seconds  for  Sample  Environment  Problem 


CUCTROh  DENSITIES. CK-3  WITHIN  THE  ORIGINAL  GRID 


Figure  3.4.  Electron  Densities  at  90  seconds  for  Sample  Environment  Problem 
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Electron  Density  Contours  at  90  seconds  for  Sample  Environment  Problem 
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Figure  3.6.  Electron  Temperatures  at  90  seconds  for  Sample  Environment  Problem 
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Figure  3.7.  Electron  Temperature  Contours  at  90  seconds  for  Sample  Environment  Problem 
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Figure  3.8.  Striation  Fraction  at  90  seconds  for  Sample  Environment  Problem 
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Figure  3.9.  Striation  Fraction  Plot  at  90  seconds  for  Sample  Environment  Problem 


shown  in  Fig.  3.3.  Note  that  at  90  seconds  the  air  has  begun  to  "heave" 
upward  above  the  burst  region.  Similar  tables  and  plots  for  electron 
density  and  electron  temperature  are  shown  in  Figs.  3.4  through  3.7. 


Tabular  data  and  a  contour  plot  of  the  striation  function  are 
shown  in  Figs.  3.8  and  3.9.  Although  the  format  is  somewhat  similar 
to  the  above  output,  these  data  are  specified  in  a  plane  normal  to  the 
magnetic  field,  and  the  contour  plot  represents  a  view  looking  down  the 
magnetic  field  from  above.  The  axis  of  this  magnetic  grid  plane  may  be 
rotated  about  the  magnetic  field  direction,  since  it  is  oriented  to 
maximize  the  information  content  used  in  the  ion  heave  calculations 
which  are  used  to  produce  the  striation  fractions.  The  rotation  angle 
of  this  plane  from  magnetic  north  is  printed  at  the  bottom  of  the  figure. 

In  addition  to  the  above  data,  tabular  outputs  for  burst  para¬ 
meters,  fireball  parameters,  and  beta  tube  parameters  are  produced  when 
a  high-altitude  burst  is  simulated.  These  are  shown  in  Table  3.2.  Note 
that  for  high-altitude  bursts,  Fireball  Set-4  (instead  of  Set-3)  is 
printed  out,  and  a  list  of  Beta-Tube  Parameters  replaces  the  table  of 
Debris  Parameters. 

Fireball  Set-4  provides  the  earth-centered  Cartesian  coordinates 
of  the  fireball,  the  grid  cell  indices  of  the  location  of  the  bottom  of 
the  fireball,  the  position  of  this  point  from  the  cell  bottom  as  a 
fraction  of  the  cell  dimension,  and  the  "fireball  kind"  index  as  des¬ 
cribed  in  the  low-altitude  environment  problem. 

The  Beta-Tube  Parameters  list  shows  the  beta  tube  shape  (straight, 
or  kinked  at  85-km  altitude),  the  initial  dip  angle  oi  the  magnetic 
field  at  the  burst  point,  the  kink  angle  from  horizontal  of  the  beta  tube 

above  85  km  (if  the  tube  is  straight,  this  angle  will  be  the  same  as  the 

dip),  the  horizontal  distance  from  a  point  directly  below  the  burst  point 

at  85  km  to  the  center  of  the  beta  tube  at  85  km,  and  the  N-S  and  E-W 

radii  of  the  tube  at  85  km  and  60  km. 


EXAMPLE  OUTPUT:  HIGH-ALTITUDE  ENVIRONMENT  PROBLEM 


3.3  RADAR  PROBLEM 


To  run  a  radar  surveillance  problem,  where: 

•  The  radar  is  located  in  the  center  of  a  local  three- 
dimensional  coordinate  system  (defined  in  the  sample 
deck) 

•  The  radar  is  the  type  provided  for  in  the  sample  deck 
and  has  a  frame  time  of  10  seconds 

•  A  burst,  as  specified  in  the  sample  deck,  occurs  at 
1620  seconds 

•  The  launch  point,  target  point,  and  object  parameters 
are  as  defined  in  the  sample  deck 

the  user  would  input: 

[Cards  read  from  bottom  to  top] 


STOP  TIME  I 

17CK. 

'SEC 

1 

i*D  DATA.  1 1|94 

1 

i  i 

1 

TIME  ) 
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SEC 

1 
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1 
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10. 

|SEC 

i 

I 

»D  DATA.fc.319 

DUMBER  ON  [TARGET 
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1  '!• 

,  1 

ItiT 

i 

i 

*D  DATA. 5(6 

1 

1 

i 

i 

Humber  of  objects  launched 

1- 

I  NT 

i 

i»B  DATh.  4344 

1 

1 

i 

i 

RADAR  LIST]  ! 

l 

j  i 

IREfCfc 

S»B  DATA.  41' 

^COMPILE  DATA  | 

i  \ 

i 

j 

I 

i 

i 

|  :  •  '  !  ■  S  'i  '  K  -4  *• 

i 

.  I*  V 

4  ,  \ 

The  event  list  in  this  case  contains  two  events  which  will  be  pro¬ 
cessed  before  the  stop  event  is  reached:  the  attack  generation  event  and 
a  burst  event.  Radar  surveillance  events  will  be  created  internally  when 
the  object  comes  into  the  radar  field  of  view. 


Output  tables  of  the  object  trajectory  parameters,  track  measure¬ 
ment  errors,  tracking  errors  as  output  from  the  filter  (only  for  a  radar 
tracking  problem),  and  two  lists  of  propagation  errors,  and  fireball 
position  data  relative  to  the  radar.  In  this  example,  the  ticking 
errors  and  fireball  position  data  have  not  been  generated.  They  can  be 
enabled  by  changing  the  search  flag  (DATA. 708)  in  the  Search  Mode  Para¬ 
meters  Dataset  from  1.0  to  0.0  and  the  flag  "Do  you  want  FB  data  relative 
to  radar"  (DATA. 55)  in  the  Basic  Dataset  from  NO  to  YES,  respectively. 

The  radar  problem  output  list  is  shown  in  Table  3.3.  It  begins 
with  the  Trajectory  Output  for  the  ob ject-and-radar  pair  specified  in 
the  sample  deck.  This  list  gives  the  actual  object  trajectory  (altitude, 
range,  azimuth,  elevation,  and  velocity)  data  at  each  radar  look  time, 
plus  the  signal-to-noise  ratio  and  the  number  of  images  seen  by  the  radar. 
The  event  type  is  displayed  in  column  1.  While  only  "SEARCH"  pulses  have 
been  generated  in  this  example,  in  a  track  simulation  the  event  type  would 
show  "SEARCH,"  "VERIFY,"  "TRACK  IN,"  and  "TRACK"  as  track  is  initiated  on 
the  object.  In  column  9,  the  number  of  targets  can  be  zero  if  the  target 
is  lost,  one  if  a  single  target  has  been  located,  or  more  than  one  if 
multipath  effects  occur. 

The  Trajectory  Output  is  followed  by  the  Track  Measurement,  which 
contains  a  list  of  the  radar-measured  target  coordinates  and  pulse-by- 
pulse  measurement  errors  in  each  coordinate.  The  predicted  position 
(colums  2-4)  is  either  equivalent  to  the  actual  position  for  search 
pulses  (as  in  this  case),  or  is  the  position  predicted  by  the  track 
filter  once  track  has  been  initialized.  The  measured  coordinates  (columns 
5-7)  are  those  generated  during  the  current  look,  and  include  all  refrac¬ 
tion  and  radar  measurement  errors. 

The  Propagation  Output  is  shown  next.  Included  in  this  table  are 
measures  of  the  absorption,  noise,  clutter,  dispersion,  and  Faraday  rota¬ 
tion  losses  as  computed  along  each  line  of  sight.  A  Hollerith  message  is 
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Table  3.3  (concluded) 
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also  printed  to  describe  the  quality  of  each  received  pulse.  This  flag 
can  have  the  following  messages: 


NO  FAILURE 
RANGE 

ABSORPTION 


ABS  +  NOISE 


S/N  received  is  above  threshold. 

The  radar  is  range (power)-limited  for  this  target. 

The  absorption  due  to  all  sources  has  reduced  the 
S/N  below  threshold. 

The  combination  of  absorption  and  fireball  noise 
has  reduced  the  S/N  below  threshold. 


TOTAL 


LOW  SIGNAL 


NO  TARGET 


The  combination  of  absorption,  noise,  dispersion, 
and  Faraday  rotation  has  dropped  the  S/N  below 
threshold . 

The  combination  of  the  above  effects  and  refrac¬ 
tion  or  clutter  has  dropped  the  S/N  below  threshold. 

There  are  no  targets  within  the  range  gate  and  3  dB 
beamwidth. 


The  second  propagation  table  gives  refraction  errors  for  both  bias 
and  random  errors.  The  bias  errors  are  due  to  the  bending  of  radar  beam 
due  to  smooth  gradients  in  electron  density,  while  the  random  errors  are 
produced  when  striations  in  the  electron  density  field  occur  (since  these 
are  treated  statistically). 

3.4  SATELLITE  COMMUNICATIONS  PROBLEM 

To  run  a  satellite  communications  problem,  where: 

•  The  ground  transmitter  and  receiver  are  co-located  directly 
beneath  the  satellite  (as  in  the  sample  problem. 

•  Communication  links  are  as  defined  in  the  sample  data  deck. 

•  A  nuclear  burst  with  the  sample  deck  yield  and  altitude 
centered  along  the  transmitter-receiver  line  of  sight  (as 
in  the  sample  deck). 
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•  Burst  occurs  at  zero  seconds. 

•  Communications  events  occur  at  100  and  200  seconds, 
the  user  would  input: 

[Cards  read  from  bottom  to  top] 


[ST Of  TIME 

201 . 

j  >Et 

> *B  BATA.  11]94 

1 

[BURST  TIME 

0. 

[SEC 

1 

*1  DATA. 1004 

TIME  STEP 

1 00. 

'SEC 

s»D  DATA.  7E|7 

| 

COMMUNICATIONS  EVENT  TIME 

10m. 

[SEC 

i»D  BATA.7i® 

^COMPILE  DATA 

1 

! 

The  Satellite-Communication  output  consists  of  propagation  and 
probability  of  bit  error  data  and  satellite  position  coordinates  with 
respect  to  the  ground  sensor  (transmitter  and  receiver)  positions.  These 
output  lists  are  shown  in  Table  3.4.  In  the  first  output  list,  the  uplink 
and  downlink  loss  factors  are  the  losses  due  to  absorption  from  all  sources 
(dimensionless)  and  the  uplink  and  downlink  scintillation  values  refer  to 
the  standard  deviation  in  phase  in  radians  due  to  scintillation  effects. 

The  probability  of  bit  error  on  the  uplink,  downlink,  and  combined  path 
are  shown  in  the  last  three  columns. 

The  second  output  list  shows  the  range,  azimuth,  and  elevation 
coordinates  of  the  satellite  with  respect  to  the  ground  transmitter 
(columns  2-4)  and  the  ground  receiver  (columns  5-7),  respectively. 
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TABLE  3.4 


3.5  OPTICAL  SURVEILLANCE  PROBLEM 


To  run  an  optical  surveillance  problem,  where: 

•  The  sensor  is  located  on  a  satellite  at  synchronous 
altitude  (default)  and  is  pointed  at  a  reference  loca¬ 
tion  near  a  low-altitude  burst. 

•  The  sensor  type  is  as  provided  for  in  the  sample  deck. 

•  The  sensor  event  occurs  at  10  seconds  after  burst. 

the  user  would  input: 

[Cards  read  from  bottom  to  top] 
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Output  for  the  optical  sensor  surveillance  problem  described  above 
consists  of  printer  plots  and  tabular  lists.  If  desired,  the  user  can 
generate  printer  plots  of  relative  radiance  at  the  focal  plane  for  each 
object  and/or  a  composite  plot  of  all  objects.  As  an  example.  Fig.  3.10 
depicts  a  composite  contour  plot  of  relative  radiance  in  the  sensor  focal 
plane  for  the  example  problem  described  above.  The  plot  shows  a  fireball 
region  and  beta  tube  region  at  ten  seconds  after  burst. 

The  output  lists  created  for  the  optical  sensor  surveillance  problem 
are  shown  in  Table  3.5.  An  Optical  Measurements  dataset  is  produced 
whenever  a  simulated  optics  event  (DATA. 940)  is  specified  (DATA. 937). 
Measurement  data  will  be  computed  and  output  whenever  the  optics  calcula¬ 
tion  type  (DATA. 879)  is  designated  as  "POINTS";  otherwise  only  zeros  will 
appear  in  the  measurement  columns  as  shown  in  the  example.  The  actual, 
measured,  and  estimated  coordinates  referred  to  in  the  list  are  measured 
in  angular  units  relative  to  the  sensor  boresight. 

The  next  output  list  shows  Integrated  Path  Data  for  each  path  in 
the  field  of  view  that  is  simulated.  The  path  is  identified  by  the  azi¬ 
muth  and  elevation  of f-boresight  (columns  3  and  4).  Column  5  is  the 
radiance  along  the  path  due  to  all  emission  and  scattering  sources.  The 
integrated  radiance  in  column  6  is  just  the  radiance  integrated  over  all 
band  intervals  (the  sum  of  the  values  shown  in  column  5  for  each  band 
interval),  and  the  sigma  due  to  structure  (column  7)  is  the  deviation  in 
the  integrated  radiance  due  to  striated  (or  structured)  regions  along  the 
path. 

The  last  tabular  output  is  produced  when  a  simulated  optics  event 
is  specified,  and  the  optics  calculation  type  (DATA. 879)  is  designated  as 
"FOV"  or  "LOCAL,"  so  that  a  scan  of  the  field  of  view  is  produced.  The 
optical  samples  represent  the  output  at  the  detector(s)  as  the  sensor  scans 
along  the  field  of  view.  Thus,  separate  rows  of  output  are  produced  as  a 
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Figure  3.10.  Signal/Noise  in  the  Image  Plane  at  T  =  10  Seconds 


function  of  time,  detector  number,  and  the  central  wavelength  of  the 
band.  The  position  of  the  detector  relative  to  the  center  of  the  field 
of  view  is  shown  in  azimuth  and  elevation  coordinates  in  columns  A  and  5. 
The  last  four  columns  show:  (1)  the  scanned  signal  output  (irradiance 
at  the  detector),  (2)  the  normalized  signal  output  (the  irradiance  nor¬ 
malized  to  the  sensor  NEFD) ,  (3)  the  final  signal  output  (after  all 
other  processing  such  as  differencing  has  been  completed),  and  (A)  the 
target  detection  flag  which  signifies  whether  the  final  signal  exceeds 
a  pre-set  threshold  designating  the  point  a  "TARGET"  versus  a  "BKGND" 
point . 


APPENDIX  A 


SAMPLE  JOB  CONTROL  STREAMS 


The  ROSCOE  program  is  most  easily  used  by  attaching  the  program  in 
its  binary  form  and  making  the  appropriate  changes  to  the  data  deck. 
However,  at  times  it  is  useful  to  make  changes  to  the  ROSCOE  subroutines 
or  ROSCOE  overlay  structure  before  execution.  The  new  data  deck  can  be 
utilized  in  either  of  these  execution  modes.  This  section  describes  sample 
job  control  streams  for  executing  ROSCOE  in  its  binary  form  and  also  for 
making  changes  to  the  ROSCOE  subroutines  or  overlay  structure.  Familiarity 
with  the  permanent  files  used  in  the  sample  job  control  streams  is  assumed. 
Brief  descriptions  of  these  files  are  provided  in  Appendix  B. 


A. 1  ROSCOE  EXECUTION  USING  BINARY  FILES 

To  execute  ROSCOE  in  its  binary  form  with  no  program  changes  the 
user  would  utilize  a  job  stream  similar  to  the  one  shown  below: 

JOB  CARD 
ACCOUNT  CARD 

ATTACH (XXI , OB INARY , ID=GRCXJ JB , CY=1) 

COPYBR (XXI , XXO , 240 ) 

ATTACH (XX2 , OBINARY , ID=GRCXJJB , CY=2 ) 

COPYBF (XX2 ,XX0) 

REWIND (XXO) 

ATTACH ( STRUCT , OSTRUCT , ID=GRCX J JB) 

UPDATE ( P=STRUCT , F , D , 8 , C=TAPE1 , L=1 ) 

BCPYL (TAPE1 , OBIN , LFILE , , , READ , REWIND , ERRORS ) 

RETURN (T APE 1, TAPE4 , BCPYL) 

ATTACH ( DATDEK , R0SC0EDATA, ID=GRCX J JB) 

UP  DAT  A ( P= DATDEK ,Q,C= INDATA , D) 

RETURN (DATDEK) 


ATTACH ( RLIBE .RLIBEROSCOE, ID=GRCXJJB) 
RETURN(TAPE1 , TAPE2 , TAPE3 , TAPE4 , TAPES , TAPE6) 
ATTACH (AMALGM8 , AMALGM8ROSCOE , ID=GRCX J JB) 
AMALGM8. 

RETURN (AMALGM8) 

LDSET(LIB=RLIBE, PRESET=ZERO, FILES=TAPEl) 
LOAD (FILE) 

NOGO. 

RETURN (LFILE) 

RETURN (RLIBE) 

ATTACH (TAPE  3 , NEWDATROSCOE , I D=GRCX J JB ) 

SENSER (PL=10000 ,,,,,,,,,,,,,,, NPR, NFLX) 
7/8/9 

*IDENT  QCHG 
*COMPILE  STRUCT 


OSTRUCT  CHANGES 


7/8/9 

*IDENT  QCHG 
*COMPILE  DATA 


ROSCOEDATA  CHANGES 


6/7/8/9 


$ 


A.  2  ROSCOE  EXECUTION  WITH  UPDATES 


To  execute  ROSCOE  with  temporary  changes  to  the  ROSCOE  subroutines 
and  overlay  structure  the  user  would  use  a  job  stream  similar  to  the  one 
shown  below: 

JOB  CARD 
ACCOUNT  CARD 
MAP (OFF) 

ATTACH (V3, ALLDECKS, ID=WDNA14X3) 

COPYCR( INPUT , UPDIR) 

REWIND (UPDIR) 

COPYSBF (UPDIR, OUTPUT) 

REWIND( UPDIR) 

UPDATE (V3, UPDIR) 

RFL (100000) 

FTN ( I=C0MPILE , LCM= I , B=M0DPR , R) 

REDUCE. 

RETURN (COMPILE) 

ATTACH (XXI , OB INARY , ID=GRCX J JB ,  CY=1 ) 

C0PYBR(XX1,XX0,240) 

ATTACH (XX2 , OB INARY , ID=GRCX J JB , CY=2 ) 

COPYBF (XX2 , XX0) 

REWIND (XXO) 

ATTACH (BCPYL , BCPYLROSCOE , ID=GRCX J JB , CY=3) 

REWIND (MODPR) 

BCPYL(XXO,MODPR,OBIN, , .APPEND) 

RETURN (XXI, XX2, XXO) 

RETURN (TAPE4 , MODPR) 

ATTACH ( STRUCT , OSTRUCT , ID=GRCX J JB ) 

UPDATE (P=STRUCT, F,D, 8, C=TAPE1,L=1) 

BCYPL (TAPE1 , OBIN, LFILE , , , RE ADI , REWIND , ERRORS) 

RETURN (TAPE1 , TAPE4 , BCPYL) 

ATTACH ( DATDEK , ROSCOEDATA , ID=GRCXJ JB) 

UPDATE (P=DATDEK , Q , C= INDATA , D) 

RETURN (DATDEK) 

ATTACH (RLIBE , RLIBEROSCOE , ID=GRCXJJB) 
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RETURN (TAPE1,TAPE2,TAPE3,TAPE4,TAPE5,TAPE6) 

ATTACH (AMALGM8 , AMALGM8R0SC0E , ID=GRCXJ JB) 

AMALGM8. 

RETURN (AMALGM8) 

LDSET(LIB=RLIBE, PRESET=ZERO, FILES=TAPE1) 

LOAD(LFILE) 

NOGO. 

RETURN (LFILE) 

RETURN(RLIBE) 

ATTACH(TAPE3 , NEWDATROSCOE , ID=GRCXJ JB) 

SENSER(PL=10000 , ,,,,,,,,,,,,, , NPR.NFLX) 

7/8/9 

*IDENT  QCHG 

PROGRAM  CHANGES (*COMPILE  CARDS  FOR  ALL  DECKS  BEING  CHANGED) 


7/8/9 

*IDENT  QCHG 
*COMPILE  STRUCT 


OSTRUCT  CHANGES 


7/8/9 

*IDENT  QCHG 
*COMPILE  DATA 


ROSCOEDATA  CHANGES 


6/7Z8/9 


APPENDIX  B 


PERMANENT  FILE  DESCRIPTIONS 

Brief  descriptions  of  permanent  files  utilized  during  ROSCOE 
executions  are  provided  below: 

ALLDECKS  -  UPDATE  library  containing  basic  ROSCOE  routines 

with  dataset  comdecks  inserted. 

OBINARY, CY=1  -  First  240  routines  of  optics  binaries. 

OBINARY ,CY=2  -  All  routines  of  optics  binaries  after  first  240. 

BCPYLROSCOE  -  Program  to  manipulate  relocatable  binary  files  in 
preparation  for  use  by  the  system  loader. 

OSTRUCT  -  Optics  version  of  overlay  structure  file  in  UPDATE 

library  form. 

ROSCOEDATA  -  New  ROSCOE  data  deck  in  UPDATE  library  form. 

RLIBEROSCOE  -  Binary  file  containing  ROSCOE  auxiliary  routines. 

AMALGM8 ROSCOE  -  Program  to  merge  data  files. 

NEWDATROSCOE  -  Auxiliary  optics  data  file. 


IBIn  A. 
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